<!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.0 Transitional//EN">
<html lang="en">
<head>
  <meta name="copyright" content=
  "Copyright (c) IBM Corporation and others 2008, 2011. This page is made available under license. For full details see the LEGAL in the documentation book that contains this page.">
  <meta http-equiv="Content-Type" content="text/html; charset=utf-8">
  <meta http-equiv="Content-Style-Type" content="text/css">
  <link rel="STYLESHEET" href="../book.css" charset="ISO-8859-1" type="text/css">
  <script language="JavaScript" src="PLUGINS_ROOT/org.eclipse.help/livehelp.js" type="text/javascript"></script>
  <title>Secure storage runtime options</title>
</head>
<body bgcolor="#FFFFFF">
  <h1 class="Head">Secure storage runtime options</h1>
  <h4>Changing location of secure storage</h4>
  <p>By default, secure storage is located in your home directory. On Windows that typically resolves to
  <i>"C:\Documents and Settings\&lt;user_name&gt;\.eclipse\org.eclipse.equinox.security"</i>. This location is selected
  to allow multiple Eclipse-based applications to share the same secure storage.</p>
  <p>If you would like to modify the location of the default secure storage, you can use the "-eclipse.keyring
  &lt;file_path&gt;" runtime option. The &lt;file_path&gt; is a path to the file which is used to persist the secure
  storage data.</p>
  <p>The current location of the default secure storage can be found on the <a class="command-link" href=
  'javascript:executeCommand("org.eclipse.ui.window.preferences(preferencePageId=org.eclipse.equinox.security.ui.storage)")'>
  <img src="PLUGINS_ROOT/org.eclipse.help/command_link.svg" alt="command link"> <strong>General &gt; Security &gt;
  Secure Storage</strong></a> preferences page.</p>
  <h4>Password file</h4>
  <p>The password provider mechanism can be bypassed if you specify the "-eclipse.password &lt;file path&gt;" runtime
  option. In this case the contents of the file you specified as the argument will be used as a master password. While
  this option is valuable in some circumstances (such as headless applications), the protection of the password file
  becomes a consideration. The password file can be protected by the operating system access rights and/or by placing
  it on a removable storage, such as a USB key.</p>
  <h3 class="related">Related concepts</h3><a href="ref-securestorage-start.htm">Secure storage</a><br>
  <a href="ref-securestorage-works.htm">How secure storage works</a><br>
  <a href="ref-securestorage-recovery.htm">Password recovery</a><br>
  <a href="ref-securestorage-passwd.htm">Life of a master password</a>
  <h3 class="related">Related reference</h3><a href="ref-securestorage-prefs.htm">Secure storage preference page</a>
</body>
</html>
